Shareware Grab Bag/Shareware Grab Bag.iso/002/edwin13.arc/EDWIN.DOC

Text File | 1986-05-09 | 11.0 KB | 233 lines

EDWIN is a programmer's editor based on the Borland Editor
Toolbox. It offers multiple editing windows, block moves between
windows, undeletion, pop-up help, Pascal structure editing,
macro record and playback, DOS invocation from the editor, and
file size limited only by available RAM.

For IBM PC and true compatibles. Keystrokes are WordStar
compatible by default, but are fully configurable. Works with
monochrome or color cards. Requires 256K.

When you first start the editor, the files EDWIN.ERR, EDWIN.KEY
and EDWIN.HLP should be in the current drive and directory.
Running the EDWINST program allows you to specify another
pathname for each file.

EDWINST will let you customize the screen colors, screen speed,
default toggles, the full keyboard, and several other defaults.
Run it while EDWIN.COM is in the default directory and it will
prompt you through.

All editor commands are summarized in the file EDWIN.HLP, which
can be typed as a text file, and also used within the editor via
the ^JH or ^OH help commands.

****************************************************************

Written by Kim Kokkonen, TurboPower Software.
Based on the Borland International Editor Toolbox.

Version 1.3 - 5/86
Telephone: [phone]  (9AM-5PM M-F Pacific Time)
Compuserve: 72457,2131
Address: TurboPower Software
         478 W. Hamilton Ave. #196
         Campbell, CA 95008

This program has been released to the public domain for personal,
non-commercial use only. You may use it yourself, give it to your
friends or co-workers, or distribute it for a cost-based fee as
part of a user's group or bulletin board service. If you wish to
distribute this program as part of a commercial package, please
contact us for a license agreement.

If you ask for support or updates of this program, please expect
to make a donation. We will ask $10 to send you the latest
version of the program.

*****************************************************************

Version 1.3 offers the following improvements:

  -The installation options have been upgraded. The installation
  program is now separate from the editor itself, contained in a
  program called EDWINST.COM. We think this is the installation
  program that Borland should use with their products.
  Keystrokes for all commands can be customized in a full screen
  editing environment. Colors and screen speed can be chosen.
  Default toggles and pathnames for the EDWIN configuration
  files can be set. The operation of EDWINST should be self-
  explanatory. Just be sure that the files EDWIN.COM, EDWIN.KEY,
  EDWIN.ERR, and EDWIN.HLP are all in the default drive and
  directory when you run EDWINST. If you change the key
  configuration to emulate a popular editor, we would like to
  get a copy of your KEY file to help others out. Unfortunately,
  the help file is not automatically updated when the keyboard
  configuration is changed. You can manually update it after you
  reconfigure the keyboard. If you do so, we would like to get a
  copy of that too.

  -A third text window has been enabled. Add a text window at
  any time with the ^OA command. Switch windows with the ^OO
  command. Shrink the current window via ^OS, and grow it with
  ^OG. Multiple windows can have the same or differing files.

  -Up to three files may be read in based on command line
  parameters. Call the program as EDWIN File1 File2 File3.

  -Memory management has been improved. Minimum memory usage per
  line is now 24 bytes instead of 48. Text line buffers are
  incremented in steps of 8 bytes rather than 16. Behavior when
  the editor runs out of memory is more graceful! Line length is
  limited to 1024 characters. Longer lines will be split up when
  the file is read. The end of line terminator is <CR><LF>.

  -Macro support has been improved. Macros are created via the
  ^JT command. The first ^JT turns macro recording on. All of
  your keystrokes will be recorded until you type ^JT again. You
  will be prompted for the macro number you want to store.
  Respond with <Enter> or a number from 1 through 9. <Enter>
  stores the "scrap" macro. This macro will be available until
  the next time you start recording. The scrap macro can be used
  in several ways, as described below. The 9 numbered macros can
  be invoked via alt-1 (top row 1) through alt-9. The "scrap"
  macro can be inserted from 1 to 9 times directly via the ^Jn
  (^J1 through ^J9) commands or for a larger (prompted) number
  of times via the ^JI command. All macros can be saved and
  loaded from files via the ^JW and ^JR options, respectively.

  -Text markers are now visible. Visibility can be toggled via
  the ^KM option. Text markers are set via the commands ^K0
  through ^K9. You can move to the associated marker with ^Q0
  through ^Q9.

  -All block operations have been sped up and cleaned up. The
  mark word (^KT) operation has been implemented.

  -Change case options (^OT,^OU,^OL) affect case of entire
  marked block, or of a single character if no block is marked.
  ^OT toggles case, ^OU uppercases, and ^OL lowercases. The
  cursor must be WITHIN the marked block for change case to work
  within the entire block.

  -Find (^QF) and replace (^QA) now support options for case-
  sensitive searching, whole words only, and backwards searches.
  Search speed has been improved by about an order of magnitude.
  Thanks to Randy Forgaard for the speedy INLINE search code.

  -Search and replace add a new feature. They can be confined to
  operate within just a marked block. The block must be visible
  for this to work, and you must choose the M option from the
  search or replace menu to activate it. We believe that the
  block search/replace option is more useful than the
  search/replace for "n" times option, which is not implemented
  here.

  -There is another search related feature which is new and
  quite powerful. It is called "search and apply macro" (^QM).
  It is like search and replace except that any macro can
  applied at the location of the match rather than just
  substituting a string there. You use it just like ^QA except
  that you specify a previously stored macro number (1..9 or
  <Enter> for the current scrap macro) instead of a replace
  string. You'll need to be careful with this one. Applying a
  macro which itself does a find or replace will lead to
  disaster. Use it carefully until you understand what it can do.

  -If you do a global (G) or marked (M) replace, each preview
  will produce a prompt with the options Y/N/A/Q. Y means change
  this instance and search again, N means don't change this one
  but continue searching, A means change this one and all others
  thereafter without prompting, and Q means quit right now.

  -Built-in help (^OH or ^JH) now scrolls with the keypad, and
  scrolls page by page rather than line by line.

  -"Snow control" is fixed, unfortunately at the expense of
  screen speed on IBM color graphics adapters. Try the EDWINST
  program to determine if your color display card can run faster
  without snow.

  -"Smart tabs" a la the Turbo Pascal editor have been
  implemented. All but some of the more quirky behavior of Turbo
  is implemented here.

  -By default, tab characters are expanded to spaces during
  read-in of any file. These expansions occur on standard 8
  column boundaries. WARNING: the tabs are lost if you write the
  file out again. EDWIN does not reconvert them to tabs. An
  installation option allows you to leave tabs unchanged during
  read-in.

  -Move to previous cursor position (^QP) has been implemented.

  -Restore current line (^QL) has been implemented.

  -All of the command prompts for strings (like filenames,
  search and replace strings, directories) are now supported by
  a command line editor with the same functionality as that in
  the Turbo Pascal editor. ^R restores the previous value, ^D
  brings it back a character at a time, ^S/^H delete it, ^V
  toggles insert mode, etc. The IBM keypad is also functional
  here. Thanks to Bela Lubkin for this code (and also for his
  EXEC function).

  -Read and write block commands leave the block markers
  properly set.

  -The end of file marker written to the end of EDWIN files is
  selectable as an installation option. By default, a ^Z
  character is written to the end of all files. This can be
  changed to no terminator (useful with DOS append commands) or
  to a <CR><LF>^Z terminator.

  -A command to append block to file has been added. ^KA writes
  the marked block to the end of the named file, using a
  technique to avoid embedded ^Z (end of file) marks in the
  result. It protects against the standard WordStar files which
  are padded to 128 byte boundaries with ^Z's.

  -All write operations are now buffered (through a 4K buffer)
  for a 2-3x speed improvement.

  -The DOS shell now gives all available memory to the command
  processor. Actual amount will vary from about 20K minimum up
  to about 400K free. Since the technique uses only non-
  fragmented heap space as part of the DOS free space, it is
  possible that a fragmented heap will cause very little memory
  to be available to DOS in spite of the fact that the ^OM EDWIN
  command reports lots of free memory. The only way to get
  around this is to save all opened files and quit to the main
  menu via the ^KD command.

  -A DOS critical error handler is installed within the program.
  This keeps drive or printer errors from crashing EDWIN with
  Abort, Retry, Ignore messages. Thanks (again) to Bela Lubkin
  for this code.

  -Primitive text processing commands have been added. ^OR sets
  the right margin. ^OW toggles word wrap mode on and off. ^B
  reformats a "paragraph" to fill within the right margin. A
  paragraph is any sequence of text lines terminated with a
  blank line. Word wrap mode must be active for ^B to perform
  filling. ^B operation is affected by whether Autoindent mode
  is active. If Autoindent is on, each line of a reformatted
  paragraph will be indented the same as the line on which
  reformatting started. If Autoindent is off, the first line of
  a paragraph may be indented while succeeding lines will be
  flush left in column 1. Automatic word wrap (a new line
  inserted whenever you type beyond the current margin) is also
  supported by this version whenever word wrap is active.

  -A full complement of "jump to" commands is available. You can
  jump to a specific line number with the ^ON command, to a
  specific column number with the ^OC command, and to a specific
  window with the ^OQ command. Windows are numbered starting
  from 1 for the top window on the screen. In addition, any of
  the "jump to" commands can be used in a relative sense. If you
  respond to the prompt for a line number with, e.g., +10, the
  jump will be made to 10 lines below the current one.
  Similarly, -20 would jump 20 lines toward the beginning of the
  file. These relative jumps may be useful in designing macros
  for the editor.